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1. Preface 

This document presents the Sun-2 SCSI Board Diagnostic. 



1.1. Purpose 

It is the intention of this document to give the user the knowledge of how to use the diag- 
nostic to test and debug the SCSI boards. 



1.2. Audience 

Members of any of the following four departments may find this document of interest for 
various reasons: (1) Manufacturing, (2) Field Service, (3) Diagnostics and (4) Documentation. 

Manufacturing and Field Service personnel will use the Sun-2 SCSI diagnostic for testing 
and/or trouble shooting purposes. Member(s) of the Diagnostic department will review the 
design of this diagnostic based on this document. Finally, Documentation will use this document 
as a basis for developing the User's Guide which will be shipped with the product itself. 

The reader of this document assumed toJiawjome knowledge of understanding Sun-2 SCSI 
Board and SCSI board together with a general knowledge of Sun-2 architecture. The user is 
strongly adviced to review the Engineering Manual for the Sun-2 SCSI Board and related 
sources. 



2. Revision History 

Revision B July 23, 1985 Second release of this document. 

3. Glossary 

The term station and machine denotes a Sun-2 work statioir. 
The term Program, Diagnostic means the SCSI Diagnostic. 
The term Disk, means any SCSI disk. 
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4. Introduction 

The SCSI Board Diagnostic is used to test the full functionality of the SUN SCSI Board. 
The diagnostic provides a set of easy to use scope loop to help the user to troubleshoot the 
board. 



4.1. Applicable Documents 

The following documents are useful in-botlLunderstanding the diagnostic and the SCSI 
board: Sun SCSI Programmera' Manual, W. M. Bradley Sun SCSI Board Theory of Operation, 
W. M. Bradley Introduction to he SASI/ SCSI Interface and the Adaptec Controller, 5/23/83, Bill 
Stanley, Adaptec Inc. Adaptec ACB 4000 and 5000 Series Disk Controllers OEM Manual, 
5/16/83, Adaptec Inc. Controller! System Interface Specification, 8/7 f&2 Adaptec Inc. At this 
time the above specifications have not yet had assigned part numbers. 



5. General Description 

The SCSI diagnostic is a boot only diagnostic. It is designed to specifically test the Sun-2 
VME or multibus SCSI board. It is menu driven to provide S"user friendly interface environ- 
ment. 



5.1. Hardware Related Information 

This diagnostic requires the use of loop-back cables to be able to test the SCC hardware on 
the board. More information on making these cables can be obtained from Test Engineering 
Dept. 



5.2. Software Related Information 

The 2.0 release of this diagnostic facilitates a new feature that determines the type of the 
disk being used. Therefore, eliminating the restriction of using Micropolis 1304 as the only 
choice. It also gives the user the opportunity of running this diagnostic without destroying user 
or system files. 



6. Features 

The SCSI diagnostic tests the following: Interface control register. DMA counter register. 
DMA address register. Device initial selection sequence. Device ready. DMA transfer. 
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Interrupt vector. Data integrity. Timer. SCO (serial ports). It also provides j> complete set of 
tools for debugging the board. 



7. Required Configuration 

The following hardware is required for testing the SCSI board: A test station such as: 

* a SUN Workstation 

* a pair of loop-back cable 

* a means of booting the SCSI diagnostic, and 

* a monitor. The monitor may either be a "(/um6 terminar or a Sun monitor, video board, 
and keyboard. A known good disk drive. A power cable for the disk (PN: 530-xxxx-x). A 
known good Adaptec board (PN: 370-1010-01). A power cable for the Adaptec board (PN: 
530-xxxx-x). 



8. Error Handler 

Upon receiving an error indication, the test will immediately terminate and call the Error 
Handler routine. The Error Handler decodes the error log structure into meanningful and useful 
information such as the name of the test that failed, the condition under which error occurred, 
the expected and actual results of the operation. 



9. Tools 

Tools are provided for debugging purposes and are available only when an error condition is 
detected. They are menu driven and easy to use. Each test has its own tool. 



10. General Performance Characteristics 

The whole SCSI diagnostic will take about 2 minutes to run on a bug-free board. Upon 
completion, it will ask the user whether to run again and for how many passes. 



11. Operating Instructions 

Configure the workstation as described above. Immediately before loading the SCSI diag- 
nostic, give the following PROM monitor command: 

>k2 
This will reset the workstations memory management unit and allow the test to do its own 
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mapping to the serial ports on the SCSI board. 

12. Loading And Starting 

>boot stand/scsi.diag 

The diagnostic will display the following messages: 

SUN XXX SCSI Board Diagnostic Rev. y.y mm/dd/yy 
Running on drive type & drive physical info 

where xxx is either "Multibus" or "VME," depending on the type of workstation being used. 
The drive type is the type of disk such as Micropolis 1304, , Micropolis 1325, or any other SCSI 
disk. The drive physical info is translated to drive physical parameters like: number of 
cylinders, number of alternate cylinders, number of heads, and number of sectors per track. 

The diagnostic will determine the type of disk being used and will fetch the disk partition infor- 
mation to use the swap partition to allocate data buffers in order to not destroy the system or 
user files on the disk. 

Enter A for automatic or M for manual: "Automatic" mode means that the diagnostic will 
run all tests once and give results. "Manual" means that the diagnostic will ask the user to 
choose from the menu below. 

TESTS MENU: 

1_ Test Interface Control Register 

2_ Test DMA Counter Register 

3_ Test DMA Address Register (VME only) 

4_ Test Initial Selection Sequence 

5_ Test Device Ready 

6_ Test Bus Transfer 

7_ Test DMA Transfer 

8_ Test Status Interrupt 

9_ Test DMA Overrun 

10_ Test Data integrity 

11_ Test Timer (VME only) 

12_ Test sec (Multibus only) 

13_ Test all 

Select One 

After you enter one of the selection numbers, the test will ask for the number of times to run. 
After the test ran the requested number of times, the diagnostic will re-display the above menu. 
From any menu prompt, you can stop the diagnostic by entering 'x' or 'X'. Once in manual 
mode, you cannot go to automatic mode (or vice versa) without restarting the diagnostic. If 
you chose selection 12, the SCC test will display another menu, where you can select which 
serial port to test, or all ports. Under automatic mode or under "Test all," the SCC test will 
cover all ports without giving any menu. 
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13. Tools 

When any test discovers an error condition, it gives an error message and gives the user the 
following message: 

Do you wish to use debug tools? 

Enter 'Y' or 'y' to access the tools. The diagnostic will select the appropriate tools for debug- 
ging the failed part, and display a menu of options. 



14. User Interface 

Every effort was made to make SCSI diagnostics easy to use. User interface is done with 
menus and simple prompts for the inputs required. A set of commands is available, allowing 
you to examine readable registers, reset the SCSI bus, display scb, alter cdb, ...etc. If you 
entered a string starting with a character, the diagnostic will search a command list for that 
string. If the command exists, the diagnostic will execute it. Otherwise it will give a message 
indicating that it was an invalid command and ask the user to enter "help" or "T" for the com- 
mand list. If you entered a number, it will check to see if the number is within the range of the 
menu. If so, it will execute the corresponding item. Otherwise it will give a message saying 
that the number is not in the menu. 



15. Test Descriptions 

Following sections describe all tests provided by the diagnostics: 

15.1. Test Interface Control Register 

Interface control register is tested by writing test patterns from 0x00 to 0x3F and the 
results are read back and compared with the expected results. It also checks for time out on 
read and write accesses to ICR. This test covers the read/write part of the interface control 
register, the data path to ICR, and verifies that read and write accesses do not cause time out. 
When an error is detected, an error message will be displayed indicating the condition under 
which the error occurred, the expected and actual results. At this point, the user will be 
prompted to ask if he/she wants to use debugging tools. 

15.2. Test DMA Counter Register 

DMA counter register is tested by writing test pattern from 0x0000 to OxFFFF and the 
results are read back and compared with the expected results. This test verifies that the 
counter register can be accessed. However it does not test for counter operations. This is done 
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on test DMA transfers. Error messages are displayed upon efTOr detection. At this point, the 
user will be prompted to ask if he/she wants to use debugging tools. 



15.3. Test DMA Address Register (VME only) 

If system is a SUN2 multibus, this test will be skipped and testing of DMA address register 
is then done on test DMA transfers. DMA address register is tested by writing test pattern 
from 0x0000 to OxFFFFFF and the results are read back and compared with the expected 
results. This test verifies that the address register can be access. However it does not test for 
counter operations. This is done on test DMA transfer. Error messages are displayed upon 
error detection. At this point, the user will be prompted to ask if he/she wants to use debug- 
ging tools. And the test menu is displayed again. 



15.4. Test Initial Selection Sequence 

Initial selection sequence is tested by setting select bit of interface control register and 
expecting the controller response with busy signal. The test verifies the paths of select and 
busy bits in ICR between SCSI and the controller. Error messages are displayed upon error 
detection. At this point, the user will be prompted to ask if he/she wants to use debugging 
tools. 



15.5. Test Device Ready 

Test device ready is done by issuing the test unit ready command to the controller, get- 
ting status and message back from the device. Then the test will issue the requ^t sense com- 
mand to the device. An evaluation on sense information is done. All bus transfers of com- 
mands, data, status, and messages are done using program I/O. This test covers the following 
SCSI board hardware: 

* REQ/ACK handshaking mechanism for asynchronous transfer of 
command, status, and data on the SCSI bus. 

* Control lines on ICR, such as REQ, MSG, CMD, and I/O. 

* Command/Status register. 

* Data register. If error is detected, error message will be displayed. At this point, the user 
will be prompted to ask if he/she wants to use debugging tools. 



15.6. Test DMA Transfer 

Write and read operations on one block of data (512 bytes) to and from disk are pei^ 
formed using DMA transfers. After DMA transfers are completed, the status completion block 
is checked for any error indication. The DMA counter register is checked for correct functional- 
ity. The DMA address and data register are checked by comparing the expected data and the 
actual data. This test covers the DMA circuitry which includes: 
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DMA address register, 
DMA counter register, 
DMA control circuitries, 

byte packaging mechanism. If error is detected, error message will be displayed. At this 
point, the user will be prompted to ask if he/she wants to use debugging tools. 



15.7. Test Interrupt Vector 

This test is divided into two parts: The first part writes test patterns from 0x00 to OxOF to 
the interrupt vector register and the results are read back and compared with the expected 
results. When complete, interrupt vector is then set to 26 before going to the next part of the 
test. This part of the test is executed only if the SCSI board under test is a VME SCSI board. 
The second part verifies the occurrence of correct level of interrupt. This is done by enabling 
interrupts, doing a DMA transfer and expecting an interrupt to occur. This test covers the 
interrupt vector register (if board under test is a VME SCSI board), and the interrupt circuitry. 

Error is displayed if the expected interrupt did not occur or if interrupt was caused by BUS 
ERROR. At this point, the user will be prompted to ask if he/she wants to use debugging 
tools. 



15.8. Test Data Integrity 

This test writes Ik block of data into the disk, using DMA transfer. Then the data are 
read back and compared with the expected values. This test verifies that data transferred 
between disk device and main memory. Error evaluation is done base on the error code and 
sense informations. If error is detected, error message will be displayed. Afterward, the user 
will be prompted to ask if he/she wants to use debugging tools. 



15.9. Test Timer 

To be implemented in the future version. 

15.10. Test sec 

This attempts to verify the correct functionality of both Zilog Z8530 SCC Serial Communi- 
cations Controllers. It is divided into two parts: The first part verifies the time constant regis- 
ter (WR12/WR13) for both controllers. The second part tests external loop back for all for 
serial ports in this manner: a to b, b to a, c to d and d to c, at all possible baud rates. The 
possible baud rates are : 110, 300, 600, 1200, 2400, 4800, 9600, 19200. Then values of 0x0 
through OxFF are sent through. The value transmitted is then compared against the expected 
value. Error messages are displayed upon error detection. The user will be prompted to ask if 
he/she wants to use debugging tools. 
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16. Switch Setting Worksheet 

Set the three switches on the SCSI Board as foIioTv: 

U305 6 ON, all others OFF 
U315 2 ON, all others OFF 
U312 6 ON, all others OFF 
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